Which API specification we should ref to the integration?



It depends on the way you want to connect with the distributor.

  • If you want to connect to a traditional agency, you should ref to AgencyUSB API.
  • If you want to connect to some OTA extranet, like Expedia extranet, Booking.com extranet, you should ref to ExtranetUSB API.
  • If you want both, you need to implement both APIs.


How would DerbySoft GO provide the property/hotel details to a distributor? Would that data be loaded using API (If yes, then provide API name) OR manually loaded offline? Please Advise.



The property detail is NOT in the scope of GO connection. And same for property image and other property content like amenities. We advise those that could be provided to the distributor offline directly.


What is the sourceId, distributorId in the spec?



The sourceId is used to identify your system. It would be generated in DerbySoft‘s system when you started to connect to DerbySoft. It will be sent to your endpoint in all requests.


The distributorId is the identifier of each distributor in the DerbySoft system. For testing and certification, DerbySoft will always use the test distributor DSCERTIFICATE. When connected to the production, DerbySoft will provide the real distributorId to you. Please make sure that has been set up in your system before you activate the connection to that distributor.


Would DerbySoft GO use our property id like ‘SA00001’ etc, room id like ‘T2, K1’ etc, rate id like ‘ODT1BA, ODT1BB’ etc? Or will DerbySoft map our property id to its own property id? Or will DerbySoft map our property id to distributor property id in the system and we will provide such mapping detail?



DerbySoft will NOT map your property id to either its own property id or distributor property id.

If you implemented AgencyUSB API, DerbySoft will use your property id and provide them to a distributor as well. No mapping at all.


If you implemented ExtranetUSB API, DerbySoft will use the distributor property id directly which should be mapped to your property id in your system.


Are the attributes and value in the spec all case-sensitive in both request and response?



Yes. That is correct.


What is the difference between the contact person and guests in the booking request?



The contact person is the person which made the booking. The guest is the person which will plan to check-in and stay at the property.